setContext( $context ); } $this->mSort = $this->getRequest()->getText( 'sort' ); if ( !array_key_exists( $this->mSort, $this->getFieldNames() ) || !$this->isFieldSortable( $this->mSort ) ) { $this->mSort = $this->getDefaultSort(); } if ( $this->getRequest()->getBool( 'asc' ) ) { $this->mDefaultDirection = false; } elseif ( $this->getRequest()->getBool( 'desc' ) ) { $this->mDefaultDirection = true; } /* Else leave it at whatever the class default is */ parent::__construct(); } /** * @protected * @return string */ function getStartBody() { global $wgStylePath; $sortClass = $this->getSortHeaderClass(); $s = ''; $fields = $this->getFieldNames(); # Make table header foreach ( $fields as $field => $name ) { if ( strval( $name ) == '' ) { $s .= Html::rawElement( 'th', array(), ' ' ) . "\n"; } elseif ( $this->isFieldSortable( $field ) ) { $query = array( 'sort' => $field, 'limit' => $this->mLimit ); if ( $field == $this->mSort ) { # This is the sorted column # Prepare a link that goes in the other sort order if ( $this->mDefaultDirection ) { # Descending $image = 'Arr_d.png'; $query['asc'] = '1'; $query['desc'] = ''; $alt = $this->msg( 'descending_abbrev' )->escaped(); } else { # Ascending $image = 'Arr_u.png'; $query['asc'] = ''; $query['desc'] = '1'; $alt = $this->msg( 'ascending_abbrev' )->escaped(); } $image = "$wgStylePath/common/images/$image"; $link = $this->makeLink( Html::element( 'img', array( 'width' => 12, 'height' => 12, 'alt' => $alt, 'src' => $image ) ) . htmlspecialchars( $name ), $query ); $s .= Html::rawElement( 'th', array( 'class' => $sortClass ), $link ) . "\n"; } else { $s .= Html::rawElement( 'th', array(), $this->makeLink( htmlspecialchars( $name ), $query ) ) . "\n"; } } else { $s .= Html::element( 'th', array(), $name ) . "\n"; } } $tableClass = $this->getTableClass(); $ret = Html::openElement( 'table', array( 'style' => 'border:1px;', 'class' => "mw-datatable $tableClass" ) ); $ret .= Html::rawElement( 'thead', array(), Html::rawElement( 'tr', array(), "\n" . $s . "\n" ) ); $ret .= Html::openElement( 'tbody' ) . "\n"; return $ret; } /** * @protected * @return string */ function getEndBody() { return "\n"; } /** * @protected * @return string */ function getEmptyBody() { $colspan = count( $this->getFieldNames() ); $msgEmpty = $this->msg( 'table_pager_empty' )->text(); return Html::rawElement( 'tr', array(), Html::element( 'td', array( 'colspan' => $colspan ), $msgEmpty ) ); } /** * @protected * @param stdClass $row * @return string HTML */ function formatRow( $row ) { $this->mCurrentRow = $row; // In case formatValue etc need to know $s = Html::openElement( 'tr', $this->getRowAttrs( $row ) ) . "\n"; $fieldNames = $this->getFieldNames(); foreach ( $fieldNames as $field => $name ) { $value = isset( $row->$field ) ? $row->$field : null; $formatted = strval( $this->formatValue( $field, $value ) ); if ( $formatted == '' ) { $formatted = ' '; } $s .= Html::rawElement( 'td', $this->getCellAttrs( $field, $value ), $formatted ) . "\n"; } $s .= Html::closeElement( 'tr' ) . "\n"; return $s; } /** * Get a class name to be applied to the given row. * * @protected * * @param object $row The database result row * @return string */ function getRowClass( $row ) { return ''; } /** * Get attributes to be applied to the given row. * * @protected * * @param object $row The database result row * @return array Array of attribute => value */ function getRowAttrs( $row ) { $class = $this->getRowClass( $row ); if ( $class === '' ) { // Return an empty array to avoid clutter in HTML like class="" return array(); } else { return array( 'class' => $this->getRowClass( $row ) ); } } /** * Get any extra attributes to be applied to the given cell. Don't * take this as an excuse to hardcode styles; use classes and * CSS instead. Row context is available in $this->mCurrentRow * * @protected * * @param string $field The column * @param string $value The cell contents * @return array Array of attr => value */ function getCellAttrs( $field, $value ) { return array( 'class' => 'TablePager_col_' . $field ); } /** * @protected * @return string */ function getIndexField() { return $this->mSort; } /** * @protected * @return string */ function getTableClass() { return 'TablePager'; } /** * @protected * @return string */ function getNavClass() { return 'TablePager_nav'; } /** * @protected * @return string */ function getSortHeaderClass() { return 'TablePager_sort'; } /** * A navigation bar with images * @return string HTML */ public function getNavigationBar() { global $wgStylePath; if ( !$this->isNavigationBarShown() ) { return ''; } $path = "$wgStylePath/common/images"; $labels = array( 'first' => 'table_pager_first', 'prev' => 'table_pager_prev', 'next' => 'table_pager_next', 'last' => 'table_pager_last', ); $images = array( 'first' => 'arrow_first_25.png', 'prev' => 'arrow_left_25.png', 'next' => 'arrow_right_25.png', 'last' => 'arrow_last_25.png', ); $disabledImages = array( 'first' => 'arrow_disabled_first_25.png', 'prev' => 'arrow_disabled_left_25.png', 'next' => 'arrow_disabled_right_25.png', 'last' => 'arrow_disabled_last_25.png', ); if ( $this->getLanguage()->isRTL() ) { $keys = array_keys( $labels ); $images = array_combine( $keys, array_reverse( $images ) ); $disabledImages = array_combine( $keys, array_reverse( $disabledImages ) ); } $linkTexts = array(); $disabledTexts = array(); foreach ( $labels as $type => $label ) { $msgLabel = $this->msg( $label )->escaped(); $linkTexts[$type] = Html::element( 'img', array( 'src' => "$path/{$images[$type]}", 'alt' => $msgLabel ) ) . "
$msgLabel"; $disabledTexts[$type] = Html::element( 'img', array( 'src' => "$path/{$disabledImages[$type]}", 'alt' => $msgLabel ) ) . "
$msgLabel"; } $links = $this->getPagingLinks( $linkTexts, $disabledTexts ); $s = Html::openElement( 'table', array( 'class' => $this->getNavClass() ) ); $s .= Html::openElement( 'tr' ) . "\n"; $width = 100 / count( $links ) . '%'; foreach ( $labels as $type => $label ) { $s .= Html::rawElement( 'td', array( 'style' => "width:$width;" ), $links[$type] ) . "\n"; } $s .= Html::closeElement( 'tr' ) . Html::closeElement( 'table' ) . "\n"; return $s; } /** * Get a "" element of limits. * This can be passed directly to XmlSelect::addOptions(). * * @since 1.22 * @return array */ public function getLimitSelectList() { # Add the current limit from the query string # to avoid that the limit is lost after clicking Go next time if ( !in_array( $this->mLimit, $this->mLimitsShown ) ) { $this->mLimitsShown[] = $this->mLimit; sort( $this->mLimitsShown ); } $ret = array(); foreach ( $this->mLimitsShown as $key => $value ) { # The pair is either $index => $limit, in which case the $value # will be numeric, or $limit => $text, in which case the $value # will be a string. if ( is_int( $value ) ) { $limit = $value; $text = $this->getLanguage()->formatNum( $limit ); } else { $limit = $key; $text = $value; } $ret[$text] = $limit; } return $ret; } /** * Get \ elements for use in a method="get" form. * Resubmits all defined elements of the query string, except for a * blacklist, passed in the $blacklist parameter. * * @param array $blacklist Parameters from the request query which should not be resubmitted * @return string HTML fragment */ function getHiddenFields( $blacklist = array() ) { $blacklist = (array)$blacklist; $query = $this->getRequest()->getQueryValues(); foreach ( $blacklist as $name ) { unset( $query[$name] ); } $s = ''; foreach ( $query as $name => $value ) { $s .= Html::hidden( $name, $value ) . "\n"; } return $s; } /** * Get a form containing a limit selection dropdown * * @return string HTML fragment */ function getLimitForm() { global $wgScript; return Html::rawElement( 'form', array( 'method' => 'get', 'action' => $wgScript ), "\n" . $this->getLimitDropdown() ) . "\n"; } /** * Gets a limit selection dropdown * * @return string */ function getLimitDropdown() { # Make the select with some explanatory text $msgSubmit = $this->msg( 'table_pager_limit_submit' )->escaped(); return $this->msg( 'table_pager_limit' ) ->rawParams( $this->getLimitSelect() )->escaped() . "\n\n" . $this->getHiddenFields( array( 'limit' ) ); } /** * Return true if the named field should be sortable by the UI, false * otherwise * * @param string $field */ abstract function isFieldSortable( $field ); /** * Format a table cell. The return value should be HTML, but use an empty * string not   for empty cells. Do not include the and . * * The current result row is available as $this->mCurrentRow, in case you * need more context. * * @protected * * @param string $name The database field name * @param string $value The value retrieved from the database */ abstract function formatValue( $name, $value ); /** * The database field name used as a default sort order. * * @protected * * @return string */ abstract function getDefaultSort(); /** * An array mapping database field names to a textual description of the * field name, for use in the table header. The description should be plain * text, it will be HTML-escaped later. * * @return array */ abstract function getFieldNames(); }