2 /* eslint no-underscore-dangle: "off" */
4 * URI Processor for RCFilters
6 * @param {mw.rcfilters.dm.FiltersViewModel} filtersModel Filters view model
8 mw
.rcfilters
.UriProcessor
= function MwRcfiltersController( filtersModel
) {
9 this.emptyParameterState
= {};
10 this.filtersModel
= filtersModel
;
13 this._buildEmptyParameterState();
17 OO
.initClass( mw
.rcfilters
.UriProcessor
);
22 * Replace the url history through replaceState
24 * @param {mw.Uri} newUri New URI to replace
26 mw
.rcfilters
.UriProcessor
.static.replaceState = function ( newUri
) {
27 window
.history
.replaceState(
35 * Push the url to history through pushState
37 * @param {mw.Uri} newUri New URI to push
39 mw
.rcfilters
.UriProcessor
.static.pushState = function ( newUri
) {
40 window
.history
.pushState(
50 * Get the version that this URL query is tagged with.
52 * @param {Object} [uriQuery] URI query
53 * @return {number} URL version
55 mw
.rcfilters
.UriProcessor
.prototype.getVersion = function ( uriQuery
) {
56 uriQuery
= uriQuery
|| new mw
.Uri().query
;
58 return Number( uriQuery
.urlversion
|| 1 );
62 * Update the filters model based on the URI query
63 * This happens on initialization, and from this moment on,
64 * we consider the system synchronized, and the model serves
65 * as the source of truth for the URL.
67 * This methods should only be called once on initialiation.
68 * After initialization, the model updates the URL, not the
71 * @param {Object} [uriQuery] URI query
73 mw
.rcfilters
.UriProcessor
.prototype.updateModelBasedOnQuery = function ( uriQuery
) {
76 uriQuery
= uriQuery
|| new mw
.Uri().query
;
78 // For arbitrary numeric single_option values, check the uri and see if it's beyond the limit
79 $.each( this.filtersModel
.getFilterGroups(), function ( groupName
, groupModel
) {
81 groupModel
.getType() === 'single_option' &&
82 groupModel
.isAllowArbitrary()
85 groupModel
.getMaxValue() !== null &&
86 uriQuery
[ groupName
] > groupModel
.getMaxValue()
88 // Change the value to the actual max value
89 uriQuery
[ groupName
] = String( groupModel
.getMaxValue() );
91 groupModel
.getMinValue() !== null &&
92 uriQuery
[ groupName
] < groupModel
.getMinValue()
94 // Change the value to the actual min value
95 uriQuery
[ groupName
] = String( groupModel
.getMinValue() );
101 parameters
= this._getNormalizedQueryParams( uriQuery
);
103 // Update filter states
104 this.filtersModel
.toggleFiltersSelected(
105 this.filtersModel
.getFiltersFromParameters(
110 // Update highlight state
111 this.filtersModel
.getItems().forEach( function ( filterItem
) {
112 var color
= parameters
[ filterItem
.getName() + '_color' ];
114 filterItem
.setHighlightColor( color
);
116 filterItem
.clearHighlightColor();
119 this.filtersModel
.toggleHighlight( !!Number( parameters
.highlight
) );
121 // Check all filter interactions
122 this.filtersModel
.reassessFilterInteractions();
126 * Get parameters representing the current state of the model
128 * @return {Object} Uri query parameters
130 mw
.rcfilters
.UriProcessor
.prototype.getUriParametersFromModel = function () {
134 this.filtersModel
.getParametersFromFilters(),
135 this.filtersModel
.getHighlightParameters(),
137 highlight
: String( Number( this.filtersModel
.isHighlightEnabled() ) )
143 * Build the full parameter representation based on given query parameters
146 * @param {Object} uriQuery Given URI query
147 * @return {Object} Full parameter state representing the URI query
149 mw
.rcfilters
.UriProcessor
.prototype._expandModelParameters = function ( uriQuery
) {
150 var filterRepresentation
= this.filtersModel
.getFiltersFromParameters( uriQuery
);
152 return $.extend( true,
155 this.filtersModel
.getParametersFromFilters( filterRepresentation
),
156 this.filtersModel
.extractHighlightValues( uriQuery
),
158 highlight
: String( Number( uriQuery
.highlight
) )
164 * Compare two URI queries to decide whether they are different
165 * enough to represent a new state.
167 * @param {Object} currentUriQuery Current Uri query
168 * @param {Object} updatedUriQuery Updated Uri query
169 * @return {boolean} This is a new state
171 mw
.rcfilters
.UriProcessor
.prototype.isNewState = function ( currentUriQuery
, updatedUriQuery
) {
172 var currentParamState
, updatedParamState
,
173 notEquivalent = function ( obj1
, obj2
) {
174 var keys
= Object
.keys( obj1
).concat( Object
.keys( obj2
) );
175 return keys
.some( function ( key
) {
176 return obj1
[ key
] != obj2
[ key
]; // eslint-disable-line eqeqeq
180 // Compare states instead of parameters
181 // This will allow us to always have a proper check of whether
182 // the requested new url is one to change or not, regardless of
183 // actual parameter visibility/representation in the URL
184 currentParamState
= this._expandModelParameters( currentUriQuery
);
185 updatedParamState
= this._expandModelParameters( updatedUriQuery
);
187 return notEquivalent( currentParamState
, updatedParamState
);
191 * Check whether the given query has parameters that are
192 * recognized as parameters we should load the system with
194 * @param {mw.Uri} [uriQuery] Given URI query
195 * @return {boolean} Query contains valid recognized parameters
197 mw
.rcfilters
.UriProcessor
.prototype.doesQueryContainRecognizedParams = function ( uriQuery
) {
199 validParameterNames
= Object
.keys( this._getEmptyParameterState() )
200 .filter( function ( param
) {
201 // Remove 'highlight' parameter from this check;
202 // if it's the only parameter in the URL we still
203 // want to consider the URL 'empty' for defaults to load
204 return param
!== 'highlight';
207 uriQuery
= uriQuery
|| new mw
.Uri().query
;
209 anyValidInUrl
= Object
.keys( uriQuery
).some( function ( parameter
) {
210 return validParameterNames
.indexOf( parameter
) > -1;
213 // URL version 2 is allowed to be empty or within nonrecognized params
214 return anyValidInUrl
|| this.getVersion( uriQuery
) === 2;
218 * Remove all parameters that have the same value as the base state
219 * This method expects uri queries of the urlversion=2 format
222 * @param {Object} uriQuery Current uri query
223 * @return {Object} Minimized query
225 mw
.rcfilters
.UriProcessor
.prototype.minimizeQuery = function ( uriQuery
) {
226 var baseParams
= this._getEmptyParameterState(),
227 uriResult
= $.extend( true, {}, uriQuery
);
229 $.each( uriResult
, function ( paramName
, paramValue
) {
231 baseParams
[ paramName
] !== undefined &&
232 baseParams
[ paramName
] === paramValue
234 // Remove parameter from query
235 delete uriResult
[ paramName
];
243 * Get the adjusted URI params based on the url version
244 * If the urlversion is not 2, the parameters are merged with
245 * the model's defaults.
248 * @param {Object} uriQuery Current URI query
249 * @return {Object} Normalized parameters
251 mw
.rcfilters
.UriProcessor
.prototype._getNormalizedQueryParams = function ( uriQuery
) {
252 // Check whether we are dealing with urlversion=2
253 // If we are, we do not merge the initial request with
254 // defaults. Not having urlversion=2 means we need to
255 // reproduce the server-side request and merge the
256 // requested parameters (or starting state) with the
258 // Any subsequent change of the URL through the RCFilters
259 // system will receive 'urlversion=2'
260 var hiddenParamDefaults
= {},
261 base
= this.getVersion( uriQuery
) === 2 ?
263 this.filtersModel
.getDefaultParams();
265 // Go over the model and get all hidden parameters' defaults
266 // These defaults should be applied regardless of the urlversion
267 // but be overridden by the URL params if they exist
268 $.each( this.filtersModel
.getFilterGroups(), function ( groupName
, groupModel
) {
269 if ( groupModel
.isHidden() ) {
270 $.extend( true, hiddenParamDefaults
, groupModel
.getDefaultParams() );
274 return this.minimizeQuery(
275 $.extend( true, {}, hiddenParamDefaults
, base
, uriQuery
, { urlversion
: '2' } )
280 * Get the representation of an empty parameter state
283 * @return {Object} Empty parameter state
285 mw
.rcfilters
.UriProcessor
.prototype._getEmptyParameterState = function () {
286 // Override empty parameter state with the sticky parameter values
287 return $.extend( true, {}, this.emptyParameterState
, this.filtersModel
.getStickyParams() );
291 * Build an empty representation of the parameters, where all parameters
292 * are either set to '0' or '' depending on their type.
293 * This must run during initialization, before highlights are set.
297 mw
.rcfilters
.UriProcessor
.prototype._buildEmptyParameterState = function () {
298 var emptyParams
= this.filtersModel
.getParametersFromFilters( {} ),
299 emptyHighlights
= this.filtersModel
.getEmptyHighlightParameters();
301 this.emptyParameterState
= $.extend(
309 }( mediaWiki
, jQuery
) );