WP_List_Table::row_actions() WordPress Method
The WP_List_Table::row_actions() method is used to generate the HTML for the row action links on a list table. This method is called by the WP_List_Table::display_rows() method for each row in the list table. The row_actions() method accepts two arguments: an array of actions (which should be associative arrays with 'label' and 'url' keys), and a boolean value for whether to escape the labels. The method returns a string of HTML for the action links.
WP_List_Table::row_actions( string[] $actions, bool $always_visible = false ) #
Generates the required HTML for a list of row action links.
Parameters
- $actions
(string[])(Required)An array of action links.
- $always_visible
(bool)(Optional)Whether the actions should be always visible.
Default value: false
Return
(string) The HTML for the row actions.
More Information
Call this method (usually from one of your column methods) to insert a row actions div. The $actions parameter should be an associative array, where the key is the name of the action and the value is a link.
Source
File: wp-admin/includes/class-wp-list-table.php
protected function row_actions( $actions, $always_visible = false ) { $action_count = count( $actions ); if ( ! $action_count ) { return ''; } $mode = get_user_setting( 'posts_list_mode', 'list' ); if ( 'excerpt' === $mode ) { $always_visible = true; } $out = '<div class="' . ( $always_visible ? 'row-actions visible' : 'row-actions' ) . '">'; $i = 0; foreach ( $actions as $action => $link ) { ++$i; $sep = ( $i < $action_count ) ? ' | ' : ''; $out .= "<span class='$action'>$link$sep</span>"; } $out .= '</div>'; $out .= '<button type="button" class="toggle-row"><span class="screen-reader-text">' . __( 'Show more details' ) . '</span></button>'; return $out; }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
3.1.0 | Introduced. |