TL; DR
นี่เป็นปัญหาที่น่าสนใจอย่างแน่นอน
นี่คือวิธีที่ฉันเข้าใจระบบ แต่ฉันอาจไม่ถูกต้อง 100%
ดังที่คุณเห็นการคลิกคอลัมน์ส่วนหัวจะสร้างคำขอ AJAX ไปยังเส้นทางต่อไปนี้: /admin_key/mui/index/render
ด้วยพารามิเตอร์ต่อไปนี้:
- ฟิลเตอร์ [placeholder]
- isAjax
- namespace
- เพจ [ปัจจุบัน]
- เพจ [PageSize]
- ค้นหา
- การเรียงลำดับ [ทิศทาง]
- การเรียงลำดับ [ข้อมูล]
อันสุดท้ายคือฟิลด์ที่คุณกำลังเรียงลำดับกริดของคุณ
เส้นทางนี้มีการประกาศตามค่าเริ่มต้นในapp/code/Magento/Ui/view/base/ui_component/etc/definition.xml
:
<insertListing class="Magento\Ui\Component\Container">
<argument name="data" xsi:type="array">
<item name="config" xsi:type="array">
<item name="component" xsi:type="string">Magento_Ui/js/form/components/insert-listing</item>
<item name="update_url" xsi:type="url" path="mui/index/render"/>
<item name="render_url" xsi:type="url" path="mui/index/render"/>
<item name="autoRender" xsi:type="boolean">false</item>
<item name="dataLinks" xsi:type="array">
<item name="imports" xsi:type="boolean">true</item>
<item name="exports" xsi:type="boolean">false</item>
</item>
<item name="realTimeLink" xsi:type="boolean">true</item>
</item>
</argument>
</insertListing>
แต่ในรายการ ui_component XML จะมีการประกาศด้วย:
<argument name="data" xsi:type="array">
<item name="config" xsi:type="array">
<item name="component" xsi:type="string">Magento_Ui/js/grid/provider</item>
<item name="update_url" xsi:type="url" path="mui/index/render"/>
<item name="storageConfig" xsi:type="array">
<item name="indexField" xsi:type="string">page_id</item>
</item>
</item>
</argument>
เราต์นี้จัดการโดยapp/code/Magento/Ui/Controller/Adminhtml/Index/Render.php
ยึดตามพารามิเตอร์เนมสเปซ (ซึ่งโดยปกติจะเป็นชื่อขององค์ประกอบ UI ของคุณ)
public function execute()
{
if ($this->_request->getParam('namespace') === null) {
$this->_redirect('admin/noroute');
return;
}
$component = $this->factory->create($this->_request->getParam('namespace'));
$this->prepareComponent($component);
$this->_response->appendBody((string) $component->render());
}
ตำแหน่งที่prepareComponent
เมธอดจะเรียกซ้ำบนคอมโพเนนต์ชายน์:
protected function prepareComponent(UiComponentInterface $component)
{
foreach ($component->getChildComponents() as $child) {
$this->prepareComponent($child);
}
$component->prepare();
}
เมื่อเตรียมส่วนประกอบของคอลัมน์การเรียงลำดับคอลัมน์จะถูกจัดการโดยapp/code/Magento/Ui/Component/Listing/Columns/Column.php
:
public function prepare()
{
$this->addFieldToSelect();
$dataType = $this->getData('config/dataType');
if ($dataType) {
$this->wrappedComponent = $this->uiComponentFactory->create(
$this->getName(),
$dataType,
array_merge(['context' => $this->getContext()], (array) $this->getData())
);
$this->wrappedComponent->prepare();
$wrappedComponentConfig = $this->getJsConfig($this->wrappedComponent);
// Merge JS configuration with wrapped component configuration
$jsConfig = array_replace_recursive($wrappedComponentConfig, $this->getJsConfig($this));
$this->setData('js_config', $jsConfig);
$this->setData(
'config',
array_replace_recursive(
(array)$this->wrappedComponent->getData('config'),
(array)$this->getData('config')
)
);
}
$this->applySorting();
parent::prepare();
}
โดยที่applySorting()
เมธอดนั้นอิงตามพารามิเตอร์การเรียงลำดับและเพียงเพิ่มคำสั่งไปยังผู้ให้บริการข้อมูล:
protected function applySorting()
{
$sorting = $this->getContext()->getRequestParam('sorting');
$isSortable = $this->getData('config/sortable');
if ($isSortable !== false
&& !empty($sorting['field'])
&& !empty($sorting['direction'])
&& $sorting['field'] === $this->getName()
) {
$this->getContext()->getDataProvider()->addOrder(
$this->getName(),
strtoupper($sorting['direction'])
);
}
}
เมื่อทุกองค์ประกอบถูกเตรียมไว้คลาสการกระทำจะแสดงส่วนประกอบ (ซ้ำอีกครั้ง) สำหรับการตอบสนอง:
$this->_response->appendBody((string) $component->render());
ฉันคิดว่านั่นเป็นขั้นตอน PHP ที่สำคัญของสิ่งที่เกิดขึ้นระหว่างการเรียงลำดับ
ตอนนี้ถึง JS แล้ว URL การแสดงผลและการอัพเดท (ประกาศในdefinition.xml
ด้านบน) จะถูกกำหนดให้กับองค์ประกอบในapp/code/Magento/Ui/view/base/web/js/form/components/insert.js
:
return Element.extend({
defaults: {
content: '',
template: 'ui/form/insert',
showSpinner: true,
loading: false,
autoRender: true,
visible: true,
contentSelector: '${$.name}',
externalData: [],
params: {
namespace: '${ $.ns }'
},
renderSettings: {
url: '${ $.render_url }',
dataType: 'html'
},
updateSettings: {
url: '${ $.update_url }',
dataType: 'json'
},
imports: {},
exports: {},
listens: {},
links: {
value: '${ $.provider }:${ $.dataScope}'
},
modules: {
externalSource: '${ $.externalProvider }'
}
}
ยังคงอยู่ในไฟล์นี้มีrequestData
วิธีการที่ใช้เพื่อดึงข้อมูล AJAX:
requestData: function (params, ajaxSettings) {
var query = utils.copy(params);
ajaxSettings = _.extend({
url: this['update_url'],
method: 'GET',
data: query,
dataType: 'json'
}, ajaxSettings);
this.loading(true);
return $.ajax(ajaxSettings);
}
คุณจะเห็นว่าวิธีนี้เรียกว่าเมื่อrender()
วิธีการที่เรียกว่า:
$.async({
component: this.name,
ctx: '.' + this.contentSelector
}, function (el) {
self.contentEl = $(el);
self.startRender = true;
params = _.extend({}, self.params, params || {});
request = self.requestData(params, self.renderSettings);
request
.done(self.onRender)
.fail(self.onError);
});
เมื่อเสร็จแล้วจะมีการเรียกวิธีการโทรกลับเพื่อใช้ข้อมูล มันคือonRender()
:
onRender: function (data) {
this.loading(false);
this.set('content', data);
this.isRendered = true;
this.startRender = false;
}
ฉันคิดว่านั่นคือสิ่งที่เนื้อหาใหม่ถูกนำไปใช้