通过 
搜索
搜索serendipity_hq / php_text_matrix
3.0.5
2022-08-02 21:09 UTC
Requires
- php: ^7.4|^8.0
- ext-iconv: *
- symfony/options-resolver: ^4.4|^5.4|^6.0
- thecodingmachine/safe: ^1.0|^2.0
Requires (Dev)
- ext-ast: *
- bamarni/composer-bin-plugin: ^1.4
- phpstan/phpstan: 1.8.2
- phpstan/phpstan-phpunit: 1.1.1
- rector/rector: 0.13.9
- roave/security-advisories: dev-master
- serendipity_hq/rector-config: ^1.0
- symfony/var-dumper: ^4.4|^5.4|^6.0
- thecodingmachine/phpstan-safe-rule: 1.2.0
README
Serendipity HQ 文本矩阵
将表示数据的矩阵数组渲染为纯文本表格。
支持
在以下环境中测试
当前状态
功能
- 每列都有四个方向的填充（顶部、右侧、底部和左侧），遵循CSS语法；
- 最大列宽，有切割单词或保持单词完整性的可能性（如word-wrap CSS属性）；
- 每列左对齐和右对齐；
- 可自定义的垂直、水平和交叉分隔符，包括标题和内容；
- 标题（第一行传递）具有不同的默认样式；
- 可以移除标题的第一行分隔符；
你喜欢这个库吗？
留下 ★
或者运行
composer global require symfony/thanks && composer thanks
来感谢你当前项目中使用的所有库，包括这个！
通过Composer安装Serendipity HQ Text Matrix
$ composer require serendipity_hq/component-text-matrix
该库遵循http://semver.org/版本约定。
如何使用Serendipity HQ Text Matrix
component-text-matrix允许在渲染数据为纯文本表格方面具有很大的灵活性。您可以自定义生成的表格的许多方面。
如果缺少某些功能，您可以通过创建问题并将其集成并提交拉取请求来解决它。请记住测试您的新功能：未测试的功能将不会被合并。
基本用法
要使用component-text-matrix，您只需要一个表示矩阵的数组
// The array containing the data
$data = [
[
'title' => '20.000 Leghe sotto i mari',
'author' => 'Jules Verne',
'review' => 'Una misteriosa creatura marina che affonda navi da guerra di ogni paese, la scoperta di uno straordinario mezzo meccanico - il sommergibile Nautilus capace di esplorare le profondità degli abissi marini, il suo comandante, il Capitano Nemo, un uomo nobile e generoso che cela però nell\'animo un insopprimibile desiderio di odio e di vendetta, il professor Arronax, il suo servitore Consiglio e il fiociniere Ned Land. E poi le meraviglie di un continente sconosciuto - l\'oceano e i suoi abissi - le esplorazioni attraverso tutti i mari, le lotte contro mostri spaventosi, la fede in una scienza che dovrebbe offrire all\'uomo un progresso inarrestabile, il desiderio di libertà che anima tutti i personaggi del libro.'
],
[
'title' => 'Il signore degli anelli: La compagnia dell\'anello',
'author' => 'J. R. R. Tolkien',
'review' => 'In questo primo romanzo della trilogia di Tolkien, il lettore conosce gli Hobbit, minuscoli esseri saggi e longevi. Frodo, venuto in possesso dell\'Anello del Potere, è costretto a partire per il paese delle tenebre. Un gruppo di Hobbit lo accompagna e, strada facendo, si associano alla compagnia altri esseri: Elfi, Nani e Uomini, anch\'essi legati al destino di Frodo. Le tappe del cammino li conducono attraverso molte esperienze diverse, finché la scomparsa di Gandalf, trascinato negli abissi da un\'orrenda creatura, li lascia senza guida. Così si scioglie la Compagnia dell\'Anello e i suoi membri si disperdono, minacciati da forze tenebrose, mentre la meta sembra disperatamente allontanarsi.'
],
[
'title' => 'Il leviatano',
'author' => 'T. Hobbes contraddittorietà',
'review' => 'Vitale rappresentazione dello Stato moderno, longeva e barocca figura di pensiero politico nelle sembianze di un mostro biblico, il "Leviatano" è certamente l\'opera filosofica più dibattuta degli ultimi quattro secoli: vi sono contenute le radici del moderno Stato di diritto e di esperienze politiche antiassolutistiche come la Rivoluzione francese, elementi necessari a comprendere le vicende più recenti delle democrazie europee. Pubblicato per la prima volta nel 1651, al termine di un\'epoca che aveva visto l\'Europa dilaniata da guerre civili e di religione, il "Leviatano" definisce tutte le logiche e le categorie della modernità, inclusa la loro duplicità e contraddittorietà. Perché reca in sé non solo un\'architettura di istituzioni, ma anche un campo di conflitti, non solo la stabilità, ma anche la possibilità del fallimento. Superare la forma Stato descritta in queste pagine resta una delle grandi sfide del XXI secolo.'
]
];
$table = new \SerendipityHQ\Component\component-text-matrix\component-text-matrix($data);
echo '<pre>';
echo $table->render();
echo '</pre>';
这将渲染如下表格
+-------------------------------------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|20.000 Leghe sotto i mari |Jules Verne |Una misteriosa creatura marina che affonda navi da guerra di ogni paese, la scoperta di uno straordinario mezzo meccanico - il sommergibile Nautilus capace di esplorare le profondità degli abissi marini, il suo comandante, il Capitano Nemo, un uomo nobile e generoso che cela però nell'animo un insopprimibile desiderio di odio e di vendetta, il professor Arronax, il suo servitore Consiglio e il fiociniere Ned Land. E poi le meraviglie di un continente sconosciuto - l'oceano e i suoi abissi - le esplorazioni attraverso tutti i mari, le lotte contro mostri spaventosi, la fede in una scienza che dovrebbe offrire all'uomo un progresso inarrestabile, il desiderio di libertà che anima tutti i personaggi del libro. |
+-------------------------------------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|Il signore degli anelli: La compagnia dell'anello|J. R. R. Tolkien |In questo primo romanzo della trilogia di Tolkien, il lettore conosce gli Hobbit, minuscoli esseri saggi e longevi. Frodo, venuto in possesso dell'Anello del Potere, è costretto a partire per il paese delle tenebre. Un gruppo di Hobbit lo accompagna e, strada facendo, si associano alla compagnia altri esseri: Elfi, Nani e Uomini, anch'essi legati al destino di Frodo. Le tappe del cammino li conducono attraverso molte esperienze diverse, finché la scomparsa di Gandalf, trascinato negli abissi da un'orrenda creatura, li lascia senza guida. Così si scioglie la Compagnia dell'Anello e i suoi membri si disperdono, minacciati da forze tenebrose, mentre la meta sembra disperatamente allontanarsi. |
+-------------------------------------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|Il leviatano |T. Hobbes contraddittorietà|Vitale rappresentazione dello Stato moderno, longeva e barocca figura di pensiero politico nelle sembianze di un mostro biblico, il "Leviatano" è certamente l'opera filosofica più dibattuta degli ultimi quattro secoli: vi sono contenute le radici del moderno Stato di diritto e di esperienze politiche antiassolutistiche come la Rivoluzione francese, elementi necessari a comprendere le vicende più recenti delle democrazie europee. Pubblicato per la prima volta nel 1651, al termine di un'epoca che aveva visto l'Europa dilaniata da guerre civili e di religione, il "Leviatano" definisce tutte le logiche e le categorie della modernità, inclusa la loro duplicità e contraddittorietà. Perché reca in sé non solo un'architettura di istituzioni, ma anche un campo di conflitti, non solo la stabilità, ma anche la possibilità del fallimento. Superare la forma Stato descritta in queste pagine resta una delle grandi sfide del XXI secolo.|
+-------------------------------------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
填充、列最大宽度和单词换行
通过传递一些选项到render()方法，可以自定义您的纯文本表格
$options = [
'columns' => [
'review' => [
'max_width' => 50
],
'title' => [
'max_width' => 20,
// Equal to CSS word-break: break-all
'cut' => true
]
],
'cells_padding' => 5
];
$table = new \SerendipityHQ\Component\component-text-matrix\component-text-matrix($data);
echo '<pre>';
echo $table->render($options);
echo '</pre>';
这将生成以下表格
+------------------------------+-------------------------------------+------------------------------------------------------------+
| | | |
| | | |
| | | |
| | | |
| | | |
| 20.000 Leghe sotto i | Jules Verne | Una misteriosa creatura marina che affonda navi da |
| mari | | guerra di ogni paese, la scoperta di uno |
| | | straordinario mezzo meccanico - il sommergibile |
| | | Nautilus capace di esplorare le profondità degli |
| | | abissi marini, il suo comandante, il Capitano |
| | | Nemo, un uomo nobile e generoso che cela però |
| | | nell'animo un insopprimibile desiderio di odio e |
| | | di vendetta, il professor Arronax, il suo |
| | | servitore Consiglio e il fiociniere Ned Land. E |
| | | poi le meraviglie di un continente sconosciuto - |
| | | l'oceano e i suoi abissi - le esplorazioni |
| | | attraverso tutti i mari, le lotte contro mostri |
| | | spaventosi, la fede in una scienza che dovrebbe |
| | | offrire all'uomo un progresso inarrestabile, il |
| | | desiderio di libertà che anima tutti i personaggi |
| | | del libro. |
| | | |
| | | |
| | | |
| | | |
| | | |
+------------------------------+-------------------------------------+------------------------------------------------------------+
| | | |
| | | |
| | | |
| | | |
| | | |
| Il signore degli | J. R. R. Tolkien | In questo primo romanzo della trilogia di Tolkien, |
| anelli: La compagnia | | il lettore conosce gli Hobbit, minuscoli esseri |
| dell'anello | | saggi e longevi. Frodo, venuto in possesso |
| | | dell'Anello del Potere, è costretto a partire per |
| | | il paese delle tenebre. Un gruppo di Hobbit lo |
| | | accompagna e, strada facendo, si associano alla |
| | | compagnia altri esseri: Elfi, Nani e Uomini, |
| | | anch'essi legati al destino di Frodo. Le tappe del |
| | | cammino li conducono attraverso molte esperienze |
| | | diverse, finché la scomparsa di Gandalf, |
| | | trascinato negli abissi da un'orrenda creatura, li |
| | | lascia senza guida. Così si scioglie la Compagnia |
| | | dell'Anello e i suoi membri si disperdono, |
| | | minacciati da forze tenebrose, mentre la meta |
| | | sembra disperatamente allontanarsi. |
| | | |
| | | |
| | | |
| | | |
| | | |
+------------------------------+-------------------------------------+------------------------------------------------------------+
| | | |
| | | |
| | | |
| | | |
| | | |
| Il leviatano | T. Hobbes contraddittorietà | Vitale rappresentazione dello Stato moderno, |
| | | longeva e barocca figura di pensiero politico |
| | | nelle sembianze di un mostro biblico, il |
| | | "Leviatano" è certamente l'opera filosofica più |
| | | dibattuta degli ultimi quattro secoli: vi sono |
| | | contenute le radici del moderno Stato di diritto e |
| | | di esperienze politiche antiassolutistiche come la |
| | | Rivoluzione francese, elementi necessari a |
| | | comprendere le vicende più recenti delle |
| | | democrazie europee. Pubblicato per la prima volta |
| | | nel 1651, al termine di un'epoca che aveva visto |
| | | l'Europa dilaniata da guerre civili e di |
| | | religione, il "Leviatano" definisce tutte le |
| | | logiche e le categorie della modernità, inclusa |
| | | la loro duplicità e contraddittorietà. Perché |
| | | reca in sé non solo un'architettura di |
| | | istituzioni, ma anche un campo di conflitti, non |
| | | solo la stabilità, ma anche la possibilità del |
| | | fallimento. Superare la forma Stato descritta in |
| | | queste pagine resta una delle grandi sfide del XXI |
| | | secolo. |
| | | |
| | | |
| | | |
| | | |
| | | |
+------------------------------+-------------------------------------+------------------------------------------------------------+
自定义标题和分隔符
$data = [
[
'quantity' => 'Quantity',
'description' => 'Description',
'price' => 'Price'
],
[
'quantity' => '1 month',
'description' => 'TrustBack.Me: Base plan' . PHP_EOL . 'From Sep 26 2016 to Oct 26 2016.',
'price' => '$29.00'
],
[
'quantity' => '',
'description' => 'Credit applied',
'price' => '-$29.00'
]
];
// The array containing the data
$options = [
'has_header' => true,
'cells_padding' => [0, 3],
'sep_head_v' => ' ',
'sep_head_x' => ' ',
'sep_head_h' => '-',
'sep_v' => ' ',
'sep_x' => ' ',
'sep_h' => ' ',
'show_head_top_sep' => false,
'columns' => [
'description' => [
'max_width' => 40,
// Equal to CSS word-break: break-all
'cut' => true
],
'price' => [
'align' => 'right',
'min_width' => 15
]
]
];
$table = new \SerendipityHQ\Component\component-text-matrix\component-text-matrix($data);
echo '<pre>';
echo $table->render($options);
echo '</pre>';
这是生成的表格
Quantity Description Price
-------------- -------------------------------------- ---------------------
1 month TrustBack.Me: Base plan $29.00
From Sep 26 2016 to Oct 26 2016.
Credit applied -$29.00
最后注意
- 使用
cut选项设置它为true或false以确定单词是否可以断开（请参阅wordwrapPHP函数） - 填充遵循CSS
padding规则，因此：如果填充属性有四个值- padding: 25px 50px 75px 100px;
- 顶部填充为25px
- 右侧填充为50px
- 底部填充为75px
- 左侧填充为100px
- 如果填充属性有
三个值- 顶部填充为25px
- padding: 25px 50px 75px;
- 右侧和左侧填充为50px
- 底部填充为75px
- 如果填充属性有
两个值 - padding: 25px 50px;
- 如果填充属性有
- 顶部和底部填充为25px
- 右侧和左侧填充为50px
- padding: 25px 50px 75px 100px;
如果填充属性有一个值
你喜欢这个库吗？
留下 ★
或者运行
composer global require symfony/thanks && composer thanks
来感谢你当前项目中使用的所有库，包括这个！